CheckBox Properties

Description

Properties for configuring the options for a CheckBox control.

Name
Description
Choices

Specify one or more options to display in the CheckBox control.

Class name- choices

Apply one or more CSS classes to style the CheckBox control.

Orientation

Choose how the CheckBox options are rendered: vertically, horizontally, or in mulitple columns.

Column flow

Specifies how the column choices are organized. LRTB - left to right, then top-to-bottom. TBLR, top-to-bottom, then left-to-right.

Column count

When the Orientation property is set to 'Columns' and the Column flow property is set to 'LRTB' (left-to-right top-to-bottom), then the Column count property will appear. This property simply sets how many columns should be used to display the Check Box choices.

Row count

When the Orientation property is set to 'Columns' and the Row flow property is set to 'TBLR' (top-to-bottom left-to-right), then the Row count property will appear. This property simply sets how many Rows should be used to display the Check Box choices.

Not in list rule

Define whether or not the current value of the CheckBox control should be added to the list of choices.

Bubble help

Shows bubble help for the checkbox control. Simply type a message next to the property to create the bubble help text.

Render as Button List

This property specifies whether the control should be rendered as a button list. This is typically used with mobile applications.

Button style

Defines the placement of an image relative to text for a checkbox control rendered as a button list.

Alignment

Specifies the alignment of the button labels for a checkbox control that is as a button list.

Fill width

Specify if the button list should fill its defined width.

OnSelect

Fires when an option is selected for a CheckBox control rendered as a button list.

OnClick

Fires when an option is clicked for a CheckBox control rendered as a button list.

Selected image

The image shown when an option is selected. For no image, specify <None>. Leave blank to use the default image.

Un-selected image

The image shown when a CheckBox control option is not selected.

Has custom design for checkbox appearance

Specify if the appearance of the CheckBox control options can be customized. You can control the image used to indicate if a choice is checked or not, the size of the checkmark and other aspects of the control's appearance.

Custom appearance designer

Opens the 'Customize Checkbox Style' property settings.

Custom layout when in AbsoluteLayout container

IF the CheckBox control is placed in an AbsoluteLayout container, individual controls can be manually positioned if this option is selected.

Suppress labels when in AbsoluteLayout container

Specify whether or not labels should be shown when the CheckBox control is placed in an AbsoluteLayout container.

Javascript control

Enables rendering a checkbox control as a "Javascript control", which allows full customization of the look of the checkbox options and gives access to JavaScript methods to manipulate the choices in the control.